home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / sgebak.z / sgebak
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))                                                          SSSSGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SGEBAK - form the right or left eigenvectors of a real general matrix by
  10.      backward transformation on the computed eigenvectors of the balanced
  11.      matrix output by SGEBAL
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      SUBROUTINE SGEBAK( JOB, SIDE, N, ILO, IHI, SCALE, M, V, LDV, INFO )
  15.  
  16.          CHARACTER      JOB, SIDE
  17.  
  18.          INTEGER        IHI, ILO, INFO, LDV, M, N
  19.  
  20.          REAL           V( LDV, * ), SCALE( * )
  21.  
  22. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  23.      SGEBAK forms the right or left eigenvectors of a real general matrix by
  24.      backward transformation on the computed eigenvectors of the balanced
  25.      matrix output by SGEBAL.
  26.  
  27.  
  28. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  29.      JOB     (input) CHARACTER*1
  30.              Specifies the type of backward transformation required:  = 'N',
  31.              do nothing, return immediately; = 'P', do backward transformation
  32.              for permutation only; = 'S', do backward transformation for
  33.              scaling only; = 'B', do backward transformations for both
  34.              permutation and scaling.  JOB must be the same as the argument
  35.              JOB supplied to SGEBAL.
  36.  
  37.      SIDE    (input) CHARACTER*1
  38.              = 'R':  V contains right eigenvectors;
  39.              = 'L':  V contains left eigenvectors.
  40.  
  41.      N       (input) INTEGER
  42.              The number of rows of the matrix V.  N >= 0.
  43.  
  44.      ILO     (input) INTEGER
  45.              IHI     (input) INTEGER The integers ILO and IHI determined by
  46.              SGEBAL.  1 <= ILO <= IHI <= N, if N > 0; ILO=1 and IHI=0, if N=0.
  47.  
  48.      SCALE   (input) REAL array, dimension (N)
  49.              Details of the permutation and scaling factors, as returned by
  50.              SGEBAL.
  51.  
  52.      M       (input) INTEGER
  53.              The number of columns of the matrix V.  M >= 0.
  54.  
  55.      V       (input/output) REAL array, dimension (LDV,M)
  56.              On entry, the matrix of right or left eigenvectors to be
  57.              transformed, as returned by SHSEIN or STREVC.  On exit, V is
  58.              overwritten by the transformed eigenvectors.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))                                                          SSSSGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      LDV     (input) INTEGER
  75.              The leading dimension of the array V. LDV >= max(1,N).
  76.  
  77.      INFO    (output) INTEGER
  78.              = 0:  successful exit
  79.              < 0:  if INFO = -i, the i-th argument had an illegal value.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.